home *** CD-ROM | disk | FTP | other *** search
/ Just Call Me Internet / Just Call Me Internet.iso / prog / atari / c / berm122 / bermuda.doc next >
Text File  |  1993-08-16  |  27KB  |  740 lines
  1.  
  2.                                     BERMUDA
  3.  
  4.                         The Fidonet compatible mailprocessor
  5.  
  6.  
  7.                    (C) Copyright 1991 by Jac Kersing
  8.                         ALL RIGHTS RESERVED
  9.  
  10.  
  11.                  Documentation by Jac Kersing and Theo Runia
  12.  
  13.  
  14.  
  15.           Bermuda 1.0 reference guide
  16.  
  17.  
  18.           TABLE OF CONTENTS
  19.  
  20.                                                               Page
  21.  
  22.           Section 1 - General Information                      2
  23.                       How does bermuda work                    4
  24.  
  25.           Section 2 - Configuration file command's             5
  26.                       Commandline options                      8
  27.                       Routing                                 12
  28.  
  29.           Section 3 - Hints en tips                           17
  30.  
  31.  
  32.          Section 1    GENERAL INFORMATION
  33.  
  34.  
  35.  
  36.  
  37.          Bermuda is a set of programs for processing  Fidonet  style 
  38.          messages. It uses an own messagebase format to store message. 
  39.          This  format  is  know  as 'Pandora/The  Box'  format  or  is 
  40.          sometimes referred to as 'QuickBBS' message base.  The format 
  41.          is  however  not the same as the 'QuickBBS'  format  used  on 
  42.          MS-DOS  computers.  This  messagebase is however  a  kind  of 
  43.          standard  for  the Atari ST line  of  computers.  Almost  all 
  44.          mailprocessors use this format.
  45.  
  46.          Bermuda  was  developed for tht The Box mailer.  But  can  be 
  47.          used with other mailers too (e.g. Binkley ST).
  48.  
  49.          This reference guide is just what it is,  a reference. If you 
  50.          want  to know more about fidonet and communication  then  you 
  51.          might find the user guide of Binkley ST, the documentation of 
  52.          QuickBBS ST and some other Fidonet documents usefull.
  53.          There  also  exist standard  technical  documentation  about 
  54.          Fidonet called the FTS and FTSC documents. You should be able 
  55.          to get them at the larger fidonet nodes.
  56.  
  57.  
  58.  
  59.          About the Fidonet:
  60.  
  61.          I still need to tell you something about Fidonet so lets  go. 
  62.          Fidonet consists of several nodes.
  63.          Your nodenumber: for example 2:283/333.0
  64.  
  65.          2:   Zone,   2 is Europe, 1 USA, 3 Australia etc.
  66.          283/ Net,    a net is a part of a country. A country is called a 
  67.                       region and consists mostly of several nets.
  68.                       For example 280 to 286 are The Netherlands which is 
  69.                       called Region 28.
  70.          /333  Node,  this is the BBS or mail system.  It is  open  to 
  71.                       callers and other mail systems depending on it's 
  72.                       setup.
  73.          .0   Point,  this is a single user. He uses Fidonet software to 
  74.                       get  and read mail.  He is the lowest  part  of 
  75.                       Fidonet.
  76.  
  77.  
  78.           The basic structure is:
  79.  
  80.                    Host-----------Host
  81.                    /  \
  82.                   HUB  HUB
  83.                   /  \
  84.                Node Node
  85.                /  \
  86.             Point  Point
  87.  
  88.          This  is  the basic structure  although  connections  between 
  89.          systems also exist. A Node is also referred to as BOSS if  he 
  90.          has any points under him.
  91.          
  92.          
  93.          How does bermuda work.
  94.  
  95.          Bermuda consist of 3 basic programs:
  96.  
  97.          Import, Scan and Pack
  98.  
  99.          Import:
  100.  
  101.          Import  imports  messages  that  are  recieved  from  another 
  102.          Fidonet  system.  Import  looks in your inbound  or  incoming 
  103.          files  directory for mail packets.  If found it will  extract 
  104.          the messages from it. A normal packet is called 12345678.PKT, 
  105.          the name can be almost anything, the extension is always PKT.
  106.          An archived mail packet has a different extension,  it is the 
  107.          day of the week with a number: .MO1, .WE2 ,  meaning  :Monday 
  108.          packet 1,  and wednesday packet 2.  You don't need to  bother 
  109.          with this,  import will. Import will call ARC.TTP if it finds 
  110.          an archived packet.  When unarchived it will import  all  PKT 
  111.          files.  It  will determine what the  messages  are:  Netmail, 
  112.          Echomail  or trash.  The file AREAS.BBS is used to  see  what 
  113.          areas  there  are and where  to place  the  messages.  Import 
  114.          will also look in the areas.bbs to see if echomail has to  be 
  115.          send  to other systems and will forward echomail messages  if 
  116.          needed.
  117.  
  118.          Scan:
  119.  
  120.          Scan  will scan your local messagebase for message  that  are 
  121.          entered locally, by you or your users of your BBS.
  122.          It will then export and forward the echomail messages to  the 
  123.          systems listed in the areas.bbs for that particular area.
  124.  
  125.          Pack:
  126.  
  127.          Both scan and import can and will forward echomail,  they can 
  128.          place  those forwarded messages either in netmail  (slow  and 
  129.          diskspace  consuming)  or  put them  directly  in  PKT  files 
  130.          (faster  and less diskconsuming).  Pack will look for packets 
  131.          and  call ARC.TPP to archive them.  Pack will also scan  your 
  132.          netmail  areas  and  forward any messages  that  need  to  be 
  133.          forwarded. For this Pack also needs a Route file (BERMUDA.RTE 
  134.          or  TB.RTE)  where you tell pack how and where and  via  what 
  135.          route to send mail.
  136.  
  137.          Oke got that? Hope so if not ASK your Host,Sysop,Boss etc.
  138.  
  139.          Before you start installing your software you should ask your 
  140.          Host,Sysop,Boss etc.  for your nodenumber and other  relevant
  141.          information.
  142.  
  143.  
  144.          The configuration file.
  145.  
  146.  
  147.          Bermuda needs a configuration file so it knows who it is  and 
  148.          what it should do. This file is called BERMUDA.CFG or if that 
  149.          does not exists TB.CFG (from The Box).
  150.  
  151.          The  configuration file consists of keywords that are  listed 
  152.          here.  If you place a semi colon (;) in front of a line it is 
  153.          considered to be a comment line and is ignored.
  154.  
  155.          The keywords here are only needed for Bermuda, if you use The 
  156.          Box you should read that manual too as The Box needs many more 
  157.          keywords.
  158.  
  159.  
  160.  
  161.          ADDRESS zone:net/node.point [fakenet]
  162.  
  163.                This  statement (or several if  you  have  several 
  164.                nodenumbers)  is the nodenumber issued by your Host  or 
  165.                Boss (in cases you'r a point). A Node should use .0 for 
  166.                the pointnumber.
  167.  
  168.                There is one optional number and that is  your  fakenet 
  169.                in case you are a point or you are a node with  points. 
  170.                The fakenet is a small trick because Fidonet is not all 
  171.                4D (4 dimensional, for points). The fakenet is supplied 
  172.                by your region coordinator.  It is very important to do 
  173.                this the right way.  Also your fakenet may not show  up 
  174.                in  messages.  If  you use the fakenet  statement  then 
  175.                Bermuda  will  expand  all  fakenet  addresses  in   4D 
  176.                addresses.
  177.  
  178.  
  179.                Example:  ADDRESS 2:282/301.2 6301
  180.  
  181.  
  182.          APPLICATION <anything>
  183.  
  184.                Ignored  by The Box and Bermuda.  May be used by  other 
  185.                programs to store information in the config file.
  186.  
  187.                Example:  APPLICATION Logreader c:\tb\tb.log
  188.  
  189.  
  190.          HOLD <path>
  191.  
  192.                This is the path to your outbound mail area.  Here  are 
  193.                the mail packets stored that are to be send. Do NOT use 
  194.                the  directory yourself it is for Bermuda and  The  Box 
  195.                only!
  196.  
  197.                Example:  HOLD C:\TB\OUTBOUND\
  198.  
  199.  
  200.  
  201.          KEY [#id] [!password] nodenumber <nodenumber...>
  202.  
  203.                With  KEY you specify the password(s) you use with  the 
  204.                system you exchange mail with. This password is used by 
  205.                The  Box for mailsessions and Bermuda puts it into  the 
  206.                mailpackets.
  207.  
  208.                Example:  KEY !JAC 2:283/333.0
  209.  
  210.                Means:  use  JAC as mailsession and packet pasword  for 
  211.                283/333.0
  212.  
  213.                With the #id parameter you can alter your address for a 
  214.                particular node.  Usefull when using alternets or being 
  215.                multipoint.  Bermuda will change  the from field and the 
  216.                number  in the origin to the ID for mail that  is  send 
  217.                to the nodes you mention after #id. 
  218.  
  219.                Example: KEY #90:100/100.0 90:101/333.0
  220.  
  221.                This  will  alter  your From field  and  nodenumber  in 
  222.                echomail  to  90:100/100.0  for mail that  is  send  to 
  223.                90:101/333.0. Please note that you also need to make an 
  224.                address  line for 90:100/100.0 as this is  your  number 
  225.                for zone 90.  You can also use 90:ALL,  this means  all 
  226.                nodes for zone 90. 
  227.  
  228.                Example: KEY #90:100/100.0 90:ALL
  229.  
  230.                Your system will use 90:100/100.0 for ALL 90 zone nodes.
  231.  
  232.  
  233.          LOGLEVEL <nr.>
  234.  
  235.                Loglevel  to  be  used.   1  gives  the  most  detailed 
  236.                information and 6 the lowest
  237.  
  238.                Example:  LOGLEVEL 1
  239.                
  240.  
  241.  
  242.  
  243.          NETFILE <path>
  244.  
  245.                Path to area for incoming mail and files.  Your  mailer 
  246.                puts  all  incoming files here.  The  *.PKT  files  and 
  247.                *.MO?, *.TU?, *.WE?, *.TH?, *.FR?, *.SA?, *.SU? are the 
  248.                archived mail packets. You should not fiddle with those 
  249.                that's import's task.
  250.  
  251.                Example:  NETFILE C:\TB\INBOUND\
  252.  
  253.  
  254.  
  255.          NETMAIL <path>
  256.  
  257.                This  points to your netmail area.  Use full  path  and 
  258.                name  but use NO extension.  Filenames should be max  8 
  259.                characters but you can also use numbers. They should be 
  260.                always 4 digits: 0001
  261.  
  262.                Example: NETMAIL C:\TB\NETMAIL
  263.                or:      NETMAIL C:\TB\0001
  264.  
  265.  
  266.  
  267.          STATUSLOG <file>
  268.  
  269.                The name and path of your logfile
  270.  
  271.                Example:  STATUSLOG C:\TB\TB.LOG
  272.                
  273.  
  274.  
  275.          SYSOP <name>
  276.  
  277.                The name of the sysop.
  278.  
  279.                Example:  SYSOP Jac Kersing
  280.  
  281.  
  282.          Commandline options
  283.  
  284.          You  can  specify several options on the commandline  of  the 
  285.          Bermuda utils. This is very important.
  286.  
  287.          IMPORT:
  288.  
  289.          -A <string>
  290.  
  291.                Define  the archiver to use.  Default import  and  pack 
  292.                search for ARC.TTP in the Bermuda directory.
  293.  
  294.                Example:  -A c:\tb\whatarc.ttp x
  295.          
  296.  
  297.          -G    RESERVED DO NOT USE
  298.  
  299.  
  300.          -I    RESERVED DO NOT USE
  301.  
  302.  
  303.          -K    Keep arcmail packets. Import renames them.
  304.  
  305.  
  306.          -P    Export message directly to packets.  If you are a  node 
  307.                that  is  also sending mail to other systems or if  you 
  308.                have  points you should use this.  Mail for  the  other 
  309.                systems is then directly put into a packet so that Pack 
  310.                only needs to archive them
  311.  
  312.          -R    If used once mail is only tossed if the sender is  also 
  313.                mentoined in the areas.bbs for that particlar area.  If 
  314.                used twice then the password in the mail packet is also 
  315.                checked.
  316.  
  317.          -S    Ask  for  packetname,  for manual  processing  of  mail 
  318.                packets.
  319.  
  320.  
  321.          -T    Write to the logfile.
  322.  
  323.  
  324.          -V    Verbose logging.  May be used several times but once is 
  325.                usually enough.
  326.  
  327.  
  328.          SCAN:
  329.  
  330.  
  331.          -G    RESERVED DO NOT USE
  332.  
  333.          -K    RESERVED DO NOT USE
  334.  
  335.          -M n  Write a maximum of n echomail messages.
  336.  
  337.          -P    Same as with import
  338.  
  339.          -Q    Quite mode, only gives limited information on the screen
  340.  
  341.          -T    Same as with import
  342.  
  343.  
  344.          PACK:
  345.  
  346.          -A    Same as with import
  347.  
  348.          -S    To start an IF statement in the route file.  Read  that 
  349.                part of the documentation for more info.
  350.  
  351.          -T    Same as with import
  352.  
  353.  
  354.          Routing of mail
  355.  
  356.          This part is about how and where to send mail to.
  357.  
  358.          The first important file is the AREAS.BBS file.  In this file 
  359.          you put the names and paths of the echomail areas you receive 
  360.          and send. So the systems that get the mail areas from you are 
  361.          also mentioned here.
  362.  
  363.          The  file  AREAS.BBS  must be in the same  directory  as  the 
  364.          Bermuda package is in and/or the environment variable  MAILER 
  365.          points to.
  366.          The  first line of the areas.bbs is the default origin  line. 
  367.          This  is  the  line  that  scan  puts  under  every  echomail 
  368.          messages:
  369.  
  370.          * Origin Jac's mailbox system (2:283/333)
  371.  
  372.          Scan puts the nodenumber behind it itself. You must take care 
  373.          that  the  origin line is not longer than  1  line.  Take  in 
  374.          account  the  length of the * Origin  and  nodenumber.
  375.          The next lines are the areas. Example:
  376.  
  377.          Jac's mailbox system
  378.          c:\thebox\msgs\0001 MAIL
  379.          c:\thebox\msgs\0002 ATARIST 2:283/3
  380.          c:\thebox\msgs\0003 THE-BOX 2:283/3
  381.  
  382.          Lines beginning with a semicolon (;) will be  ignored.  Every 
  383.          line consists of:
  384.  
  385.          Areapath Fidonet-name Nodenumber(s)
  386.  
  387.          The  filename  should not have an extension as it  is  stored 
  388.          like  c:\tb\msgs\0001.hdr and c:\tb\msgs\0001.msg  where  the 
  389.          *.HDR  file  is the header file and *.MSG  contains  the  raw 
  390.          messagetext. The filename can be anything you like but we use 
  391.          numbers (always 4 digits!) to make it more clear.
  392.          The  second parameter is the name of the area,  this must  be 
  393.          the official Fidonet name.
  394.          The third and following parameters are the nodenumbers of the 
  395.          systems from where you recieve the area from and/or you  send 
  396.          the  area  to.  Points can be displayed like  .2  instead  of 
  397.          2:283/333.2 so they take less room.
  398.  
  399.          There   are  a  couple  of  special  areanames  (the   second 
  400.          parameter):
  401.  
  402.          MAIL     For the netmail areas,  no nodenumers allowed  after 
  403.                   this!
  404.          BADMSGS  Bad  messages,  all corrupted messages are put  into 
  405.                   here, wrongly addressed messages stay in the netmail 
  406.                   area.
  407.          LOCAL:   This  is for areas you only have locally  and  that 
  408.                   should not be send.  Scan skips these.  You must not 
  409.                   place  any nodenumbers after this name.  Every  area 
  410.                   that  does not have any nodenumbers after it's  name 
  411.                   is considered a 'local' area.
  412.  
  413.                   Example: LOCAL:SYSOPMAIL.
  414.  
  415.          There  are  also a couple of special  options.  You  can  put 
  416.          BEFORE  every  area  a line beginning with  -  (minus).The  - 
  417.          (minus) indicates that this is a special option. An example:
  418.  
  419.          Jac's mailbox system
  420.          c:\thebox\msgs\0001 MAIL
  421.          -DAYS 12
  422.          c:\thebox\msgs\0002 ATARIST 2:283/3
  423.          -ORIGIN Jac's box
  424.          c:\thebox\msgs\0003 THE-BOX 2:283/3
  425.  
  426.          The -DAYS was used for comscan,  which is not in use anymore, 
  427.          but  some  other crunchers or packers use  this.  A  cruncher 
  428.          deletes  messages marked for deletion.  The -DAYS is used  to 
  429.          delete older messages then 12 days.  This option is not  used 
  430.          by  the  Bermuda   package,  but is  allowed  as  some  other 
  431.          crunchers may be able to use it. The -DAYS 12 is ment for the 
  432.          area ATARIST in this case.
  433.  
  434.          The  -ORIGIN is used to change the default origin  line  (the 
  435.          first line in the areas.bbs) for the next area.  So the  area 
  436.          THE-BOX  will not show 'Jac's mailbox system' in  the  origin 
  437.          but 'Jac's box'.  This way you can define a different  origin 
  438.          for  every area.  You migh want to use different origins  for 
  439.          national areas and international areas.
  440.  
  441.  
  442.  
  443.  
  444.           The TB.RTE file:
  445.  
  446.          This  is  more complex.  In this file you  tell  the  Bermuda 
  447.          package how to route (send) mail and via which paths.
  448.  
  449.          In  TB.RTE  we use wildcards,  so first a small  piece  about 
  450.          that:
  451.  
  452.          WILDCARDS:
  453.  
  454.          The '*' and '?' are the so called wildcards.  They are almost 
  455.          the  same  as in most commandline interpreters.  So  '*'  can 
  456.          replace any sequence of zero or more charcters,  and '?'  can 
  457.          replcae any single character.  Unlike other programs  however 
  458.          the packer DOES take characters after '*' into  account.  So, 
  459.          'P*' or 'P*K' can replace PACK, but 'P*X' can not.
  460.          In  this  way  nodenumbers  are  treated,  '2:*'  applies  to 
  461.          2:283/333  so  does '2:2*3,  but '2:?2*' or '2:*4'  does  not 
  462.          apply. There is a special notation for points, see POINTS.
  463.  
  464.  
  465.          KEYWORDS:
  466.  
  467.          Keywords  can  be divided into three  different  groups.  the 
  468.          first  one  applies to message handling,  the second  one  to 
  469.          packets, and the third to the route file itself.
  470.  
  471.  
  472.          Group 1
  473.  
  474.          ROUTE-TO [CRASH] [FILE] <node> <nodes>
  475.  
  476.                Messages for <nodes> are sent to <node>.
  477.  
  478.          NO-ROUTE [CRASH] [FILES] <nodes>
  479.  
  480.                Messages for <nodes> are sent directly.                  
  481.  
  482.          FORWARD-FROM [CRASH] [FILE] <nodes1> TO <nodes2>
  483.  
  484.                Messages from <nodes1> to <nodes2> are routed. Messages
  485.                from or to other nodes are not routed.  They  stay  on 
  486.                your system.
  487.  
  488.  
  489.          Group 2
  490.  
  491.          ARCMAIL <nodes>
  492.  
  493.                Mail to <nodes> is arced.
  494.                This  shold  only be used if you  are  sure  that  the 
  495.                recieving node accepts arcmail.
  496.  
  497.  
  498.  
  499.          HOLD <nodes>
  500.  
  501.                Normal mail to <nodes> is not sent.  Packets are put on 
  502.                hold to be taken by the recieving node when it  calles 
  503.                you.
  504.  
  505.          POLL <nodes>
  506.  
  507.                 Call <nodes> for mail,  also when you have nothing  to 
  508.                 send.
  509.  
  510.          REDIRECT [CRASH] <node> <nodes>
  511.  
  512.                 Packets for <nodes> are sent to <node>
  513.                 This can be done only if these packets are not arced.
  514.  
  515.  
  516.          Group 3
  517.  
  518.  
  519.          IF <tag>
  520.  
  521.                Line after this line are processed only if -S <tag> is
  522.                put on the commandline of pack.  Processing  continues 
  523.                until the next IF or the end of the route file.
  524.                 
  525.                Example: Pack -S poll
  526.  
  527.                (TB.RTE):
  528.  
  529.                ARCMAIL 283/3
  530.  
  531.                ROUTE-TO 283/3 *
  532.  
  533.                IF POLL
  534.                POLL 283/3
  535.  
  536.                If -S poll is used the command's after the IF POLL  are 
  537.                used, in this case the system will start polling 283/3.
  538.  
  539.  
  540.          Other keywords are: OURNET, BOSS, POINTS and ALL
  541.  
  542.  
  543.  
  544.          POINTS:
  545.  
  546.          For sysops:
  547.          Points  must be specified by .<number> and not by their  full 
  548.          address. Use of that is illegal.
  549.  
  550.          For points:
  551.          The  route  file for points is quite  simple.  For  a  single  
  552.          point:
  553.  
  554.          ARCMAIL BOSS
  555.          ROUTE-TO BOSS ALL
  556.  
  557.          will do. If crashmail should be routed to the boss 
  558.  
  559.          ROUTE-TO CRASH BOSS ALL
  560.          can be added.
  561.  
  562.          Multi points should add
  563.          NO-ROUTE <zone>:<net>/<node>
  564.          for all bosses expect for their first.
  565.  
  566.  
  567.          ADVANCED TOPICS:
  568.  
  569.          This is where it gets complicated..
  570.  
  571.          What would you think of:
  572.  
  573.          ROUTE-TO 2:2/$1 *:*
  574.          NO-ROUTE 2:*
  575.  
  576.  
  577.          This line takes care of zone routing. All in one line!
  578.          Well allright,  we need the second line to keep messages from 
  579.          our own zone here. They are routed normally.
  580.          Want to understand it? We will try to explain it then.
  581.  
  582.  
  583.          Let's start at the beginning:
  584.          Pack  reads a message containing a source and  a  destination 
  585.          address.  First it checks if the source address is  ours.  If 
  586.          not the program checks for FORWARD-FROM ..  TO ..  to see  if 
  587.          the  message  can  be routed.  If a crash  message  can't  be 
  588.          processed  by  a FORWARD-FROM CRASH line it's  crash  bit  is 
  589.          reset and the message is routed as a normal one.
  590.  
  591.          If  a message can be send after these checks the  destination 
  592.          address  is read and converted to a  character  string,  like 
  593.          '2:283/333'.  This  string  is used to check  for  applicable 
  594.          lines that can be used to process the message. A line applies 
  595.          if  the nodenumbers match.  If a string  has  wildcards,  all 
  596.          wildcards  are  replaced  by  the  strings  they  match.  So, 
  597.          '2:283/333'  is  matched  by '2:*/*' the  first  wildcard  is 
  598.          translated  to 283 and the other to 333.  These  translations 
  599.          can be used in the first node number after ROUTE-TO.  You can 
  600.          use them by using $x (x=1..9) in the nodenumber,  where x  is 
  601.          the  number of the wildcard counting left to right.  In  this 
  602.          example $1 translates to 283 and $2 to 333.
  603.          You should take care that there are enough wildcards to match 
  604.          these $x.
  605.          Translations of unmatched $x will give unpredictable results.
  606.  
  607.          In  the  example we started with $1 translating to  the first 
  608.          wildcard which is the zonenumber.  So messages to other zones 
  609.          are routed to 2:2/<zone>
  610.  
  611.          The is another example:
  612.  
  613.          ROUTE-TO 28$1/0 28?/*
  614.  
  615.          Now  a  message to 283/333 is sent to  283/0,  a  message  to 
  616.          282/301 to 282/0 and so on. A missing part of a nodenumber is 
  617.          replaced  by the value of the corresponding part of your  own 
  618.          private number.  In our setup both 283/333 and 282/301  apply 
  619.          to zone 2.
  620.  
  621.          The use of MAGIC WORDS in lines that contain '$x@ expressions 
  622.          can lead to unpredictable results. Please don't use them.
  623.  
  624.          In normal lines MAGIC WORDS have the following translation:
  625.  
  626.          ALL     *
  627.          OURNET  <ourzone>:<ournet>/*
  628.          BOSS    <bosszone>:<bossnet>/<bossnode>
  629.          POINTS  .*
  630.  
  631.  
  632.          PS Messages that are entered locally (i.e.  local bit is set) 
  633.          are always sent.  A message for a node that is not  mentioned 
  634.          in  the route file is sent directly.  This applies to  normal 
  635.          mail and crashmail.
  636.  
  637.  
  638.  
  639.          Section 3:
  640.  
  641.          What there is else to know.
  642.  
  643.  
  644.          Paths:
  645.  
  646.          Bermuda   uses   a   environment  variable   to   find   it's 
  647.          configuration files and so do some other utils.
  648.          You  should  use MAILER and let that point to  the  directory 
  649.          bermuda,  pack/import/scan and the configuration  files,  are 
  650.          in.  You  can  set  your environment variable if  you  use  a 
  651.          commandline   interpreter  like  Pcommand.   Put   into   the 
  652.          autoexec.bat:  SET MAILER=C:\TB\
  653.  
  654.  
  655.          Batch files:
  656.  
  657.          To run a mailer system, point BBS etc. you must either use  a 
  658.          commandline  interpreter  or a special shell.  If you  use  a 
  659.          commandline  interpreter you will need to make  batch  files. 
  660.          Your mailer will give certain errorlevels (return codes) when 
  661.          it exists.  The errorlevel depends on the action to be taken. 
  662.          An errorlevel of 20 could mean 'mail recieved' so you need to 
  663.          startup your import program. An example:
  664.  
  665.          :start
  666.          TB Unattanded
  667.  
  668.          If ERRORLEVEL 20 goto IMPORT
  669.          If ERRORLEVEL 21 goto SCAN
  670.  
  671.          :import
  672.          import -t -p -a c:\tb\whatarc.ttp x
  673.          scan -t -a c:\tb\whatarc.ttp a
  674.          goto start
  675.  
  676.          :scan
  677.          scan -t -p
  678.          pack -t -s call
  679.          goto start
  680.  
  681.  
  682.          Just to give you an idea. Try it out.
  683.  
  684.  
  685.  
  686.          Arcmail:
  687.  
  688.          Default  import and pack use ARC.TTP But arcmail is  not  the 
  689.          most used anymore as better compression techniques  are  used 
  690.          (LZH/ZIP).  To be able to use that we need a special program, 
  691.          in this case called whatarc.
  692.          In  stead of calling arc you put -A c:\tb\whatarc.ttp on  the 
  693.          commandline EVERY time pack and import is  run.  Whatarc  wil 
  694.          make it possible to send and recieve ARC/LZH/ZIP/ARJ mail.
  695.          Whatarc  has  it's own documentation and is not part  of  the 
  696.          Bermuda package.
  697.  
  698.  
  699.          Exporting mail for other systems.
  700.  
  701.          Systems  that send mail to other systems or/and  have  points 
  702.          should put -P on the commandline of import and scan. In stead 
  703.          of routing all mail via the netmail area all mail is directly 
  704.          put into packets which pack only needs to archive. This makes 
  705.          processing mail for other systems MUCH faster and it takes  a 
  706.          lot less diskspace.
  707.  
  708.  
  709.  
  710.          Using Bermuda with Binkley ST
  711.  
  712.          Bermuda  was  designed  to be used with The  Box  as  Fidonet 
  713.          mailer,  but  you can use Bermuda with Binkley  ST  too.  The 
  714.          major problem is that the outbound folder of Binkley ST has a 
  715.          different format the The Box. To make it possible for Bermuda 
  716.          to  work  with Binkley ST you need to  convert  the  outbound 
  717.          folder. To do this there is Packconv, a package that consists 
  718.          of  2 programs called BINK2TB and TB2BINK.  BINK2TB  converts 
  719.          the  outbound from Binkley ST in The Box format  and  TB2BINK 
  720.          does the opposite.  You need to run BINK2TB every time before 
  721.          you  start  up any of the Bermuda programs  and  run  TB2BINK 
  722.          before  you start up Binkley ST.  Makes you wonder why  there 
  723.          isn't a standard format...  Packconv also is not part of  the 
  724.          Bermuda package.  But both whatarc and packconv can be  found 
  725.          at most Atari ST based Fidonet systems.
  726.  
  727.  
  728.  
  729.          Oke I have talked enough,  set it up and have fun.  And don't 
  730.          forget:  always read the documentation,  and ask other people 
  731.          if you have questions. That's exactly what Fidonet is for.
  732.  
  733.          As  a final word we would like to thank all  the  betatesters 
  734.          and people with idea's for their help.
  735.  
  736.          Greetings       Theo Runia & Jac Kersing
  737.  
  738.  
  739.  
  740.